home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archives / ForCLI / 0Utils13.lha / 0Utils / GetWord.doc < prev    next >
Text File  |  1995-03-20  |  932b  |  58 lines
  1.  
  2.  
  3.     NAME
  4.     GetWord
  5.  
  6.     SYNOPSIS
  7.     GetWord - get one in a list of words - Requires v37
  8.  
  9.     INPUTS
  10.     NUMBER/N/A,WORDS/M
  11.  
  12.     FUNCTION
  13.     get a number and a couple of strings and
  14.     find the n-th string starting with 1.
  15.  
  16.     Negative numbers cause counting with the
  17.     last word.
  18.  
  19.     The resulting string is sent to STDOUT.
  20.  
  21.     Numbers, that exceed the number of words,
  22.     result in a returncode "10" (so does number=0)
  23.  
  24.     RESULT
  25.     word [number-1]
  26.  
  27.     NOTES
  28.     CLI - only
  29.  
  30.     should compile with SAS-C
  31.  
  32.     BUGS
  33.     there are problems, if GetWord is invoked with
  34.     wrong word number in Scripts: for unknown reason
  35.     the secondary result is cleared early.
  36.     (see .KnownBugs)
  37.  
  38.     The documentation wrongly stated a returncode 9
  39.     on wrong numbers.
  40.  
  41.  
  42.     EXAMPLES
  43.     >GetWord  1 ali baba
  44.     "ali"
  45.  
  46.     >GetWord -1 ali baba
  47.     "baba"
  48.  
  49.     >GetWord 3 ali baba
  50.     "GetWord: bad number"
  51.  
  52.     AUTHOR
  53.     Bernd Noll, Brunnenstrasse 55, D-67661 Kaiserslautern
  54.     noll@student.uni-kl.de
  55.  
  56.  
  57.  
  58.